home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload Trio 2 / Shareware Overload Trio Volume 2 (Chestnut CD-ROM).ISO / dir39 / ansv20.zip / AV.DOC < prev    next >
Text File  |  1993-08-29  |  10KB  |  280 lines
  1.                             ANSI View
  2.                                2.0
  3.                                 
  4.                  Copyright 1993 Robert D. Bouman
  5.                        All Rights Reserved
  6.                          August 30, 1993
  7.  
  8.  
  9. License Information :
  10.  
  11. The ANSI View software package is NOT free.  You are expected to
  12. register your copy of ANSI View within 30 days or cease all use
  13. of software.
  14.  
  15. ANSI View is not to be included with any other software package
  16. unless permission is obtained in writing from the author.
  17.  
  18. You may freely distribute the shareware version of ANSI View (in
  19. fact I encourage it) as long as all files included in the
  20. official release of ANSI View are included.  Shareware
  21. distributors may sell disks containing ANSI View as long as no
  22. fee is charged for the software itself, however, distribution
  23. fees and reimbursement for cost of media may be charged to end
  24. user as long as the fee does not exceed $5.00 (U.S. funds).
  25.  
  26. Warranty Information:
  27.  
  28. All measures have been taken to ensure that ANSI View is of the
  29. highest quality.  However, the author takes no responsibility for
  30. any loss of equipment and/or loss of data resulting from the use
  31. of ANSI View and utilities.
  32.  
  33. (See REGISTER.DOC for information on registering ANSI View)
  34.  
  35.  
  36. The Shareware Concept and What it Means to You.
  37.  
  38. Shareware is a method of marketing and distributing software that
  39. requires almost no capital (money) on the part of the author to
  40. distribute his/her software product to potential customers.  You
  41. may have downloaded ANSI View from an electronic BBS service or
  42. purchased a disk from a shareware distributor with ANSI View on
  43. it.  Simply because you have a copy of ANSI View does not mean
  44. that you own it.  In fact, after a reasonable trial period, you
  45. are encouraged to register your version of ANSI View.  There are
  46. many benefits in doing so, here are a few;
  47.  
  48. - By registering ANSI View you will receive a disk from the
  49.   author with the registered version of ANSI View on it.  The
  50.   registered version includes a menu based system to select an
  51.   ANSI file for viewing in a "Point 'n Shoot" fashion as well as
  52.   the elimination of the annoying message (and delay) when you
  53.   exit the program.
  54.  
  55. - If you register, you will be automatically notified of future
  56.   enhancements to ANSI View or related utilities.
  57.  
  58. - By registering, you help to support an industry that provides
  59.   thousands of new software titles to the public each year at
  60.   very reasonable prices.
  61.  
  62. The registration fee for ANSI View is $15.
  63.  
  64.  
  65.  
  66.                        What is ANSI View?
  67.                                 
  68. ANSI View is a DOS command line utility similar to XCOPY or MOVE
  69. that displays ANSI coded images on your computer screen.  It does
  70. this with no assistance from the ANSI.SYS device driver.  Those
  71. of you that keep ANSI.SYS installed for viewing ANSI graphics can
  72. now free your computer's memory from ANSI.SYS forever!
  73.  
  74. Since ANSI View displays full color ANSI images and animation
  75. sequences, its possible uses are boundless.  One great use for it
  76. that I have found is for viewing ANSI files from the MS-DOS Shell
  77. or MS Windows' File Manager.  By simply associating files with
  78. the extension .ANS (see perspective manuals) with AV.EXE, you can
  79. view all your favorite ANSI files easily from within a graphical
  80. environment.  Another great use for ANSI View is for setting up
  81. killer menu systems.  See information on the /K switch for how
  82. this can be done.
  83.  
  84. Of course, since ANSI View is not a memory-resident utility it
  85. does not re-map your keyboard for you as ANSI.SYS can.  But, when
  86. it comes to displaying color ANSI graphics, ANSI View blows
  87. ANSI.SYS out of the water in both speed and usability.
  88.  
  89.  
  90.                           Requirements
  91.                                 
  92. ANSI View requires :
  93.  
  94.      - IBM PC XT/AT compatible computer
  95.      - EGA or VGA color computer graphics adapter.
  96.  
  97.  
  98.  
  99.                         - INSTRUCTIONS -
  100.  
  101. ANSI View is very simple to use, if you can copy a file from the
  102. DOS command prompt you can use ANSI View.
  103.  
  104. The command line format of ANSI View is as follows;
  105.  
  106. AV <file name> [<file name>] [<prompt message>] [<switch>
  107.    <switch>]
  108.  
  109. Specifications surrounded in "[]" are optional.
  110.  
  111. In order for ANSI View to function, at least one file name must
  112. be provided on the command line.  However, you may specify as
  113. many ANSI files as you wish at the command line and ANSI View
  114. will display them in the order they were given.  DOS does
  115. unfortunately limit the total length of the command line to 128
  116. characters long however.
  117.  
  118. All DOS type wild cards can be used with ANSI View.  This
  119. includes the characters ? and * wild card characters.  For
  120. example;
  121.  
  122.      AV *.ANS *.TXT
  123.  
  124. will display all files with the extensions .ANS and .TXT in the
  125. current directory.
  126.  
  127. Also, there are four different command line switches that can be
  128. used with ANSI View to achieve desired results.  They are;
  129.  
  130.      /P - Pauses after each image displayed.
  131.      /C - Clears the screen before each image is displayed.
  132.      /K - See description below.
  133.      /? - Displays the help screen for ANSI View.
  134.  
  135. Examples;
  136.  
  137.      (1) AV *.ANS /P
  138.      (2) AV /P *.ANS
  139.      (3) AV OPENNING.ANS /P MYMENU.ANS
  140.      (4) AV OPENNING.ANS /P /C MYMENU.ANS
  141.  
  142. In example 1, all files with the .ANS extension will be displayed
  143. with a pause message between each file.  The user must press a
  144. key to view the next image.
  145.  
  146. Example 2 is exactly the same as the first.  The difference is
  147. that the /P switch is at the beginning of the command line
  148. sequence instead of at the end.  This demonstrates that ANSI View
  149. does not require that the switches be placed in any particular
  150. order, they may be mixed throughout the command line if the user
  151. prefers.
  152.  
  153. Example 3 shows how more than one file is specified on the
  154. command line.  Again, switches may be placed anywhere in the
  155. command line sequence.
  156.  
  157. Example 4 illustrates how the /C switch is used to clear the
  158. screen before each file is displayed.
  159.  
  160.  
  161.  
  162.                           - Keys - 
  163.                           
  164. Pressing the <SPACE BAR> while the computer is drawing an ANSI
  165. image on the screen will skip to the next file or exit the
  166. program.
  167.  
  168. New to ANSI View 2.0 are the <P>ause and <ESC> keys.  Pressing <P>
  169. will pause the display of the current image, press <P> again to resume
  170. display of image.  Pressing <ESC> will exit the program prematurally
  171. and return the user to the DOS command prompt.
  172.  
  173.  
  174.  
  175.               Returning Key Strokes to Batch Files
  176.                                 
  177. By using the /K switch and a prompt message, it is possible to
  178. return a keystroke value to a calling batch program for use with
  179. the ERRORLEVEL batch command.
  180.  
  181. First I'll present an example then discuss its workings.
  182.  
  183. Example:
  184.      AV TESTMENU.ANS "Please make selection from menu : " /K
  185.  
  186. The ingredients necessary for AV to return a keystroke properly
  187. are the /K switch and the prompt message.  If a prompt message is
  188. not desired then a "" must be specified in the command line.
  189.  
  190. When the /K switch is used, the last item in the command line is
  191. used for the prompt message (excluding any switch options that
  192. may follow).
  193.  
  194. In the above example, the message surrounded in quotes is used
  195. and not the /K.  Messages requiring more than one word must be 
  196. surrounded in quotes in order for ANSI View to properly interpret
  197. the message.
  198.  
  199. Prompt messages need not be surrounded in quotes, however, if they
  200. consist of only one word.  The example below will produce proper
  201. results also.
  202.  
  203. Example:
  204.      AV TESTMENU.ANS Selection? /K
  205.  
  206. This example will display the file TESTMENU.ANS and then display
  207. the message "Selection?" at the bottom of the image.
  208.  
  209. After the user has pressed the desired key the program will
  210. terminate setting the errorlevel to the value of the key that was
  211. pressed.
  212.  
  213. For a broader example of the process, see TESTMENU.BAT for an
  214. example of a menu system based around ANSI View.
  215.  
  216. A note of warning must be given, however.  If you use the /K
  217. switch from the command line and don't include a prompt, ANSI
  218. View may use the file name as a prompt and not display any file
  219. at all.  Sometimes, it may be desirable to display a prompt only
  220. with no ANSI image.  Under those circumstances, the user can
  221. simply specify the /K switch and a prompt message and ANSI View
  222. will display the prompt and return the key stroke but will not
  223. display an image.
  224.  
  225. One last note on the /K switch.  It is possible to specify more
  226. than one file name with the /K switch.  The prompt message (or
  227. the last item in the command line) will be displayed at the
  228. bottom of the last image displayed.
  229.  
  230.  
  231.  
  232.                     Adjusting the Line Height
  233.                                 
  234. Included with the ANSI View package are seven utilities designed
  235. to adjust the character heighth of EGA/VGA display terminal
  236. types.
  237.  
  238. The names of the utilities and their function are given below.
  239.  
  240.  Name            Function                      Hardware Required
  241. ------          ----------                    -------------------
  242. 12R.EXE          Set screen to 12 chars. high         VGA
  243. 14R.EXE          Set screen to 14 chars. high         VGA
  244. 21R.EXE          Set screen to 21 chars. high         VGA
  245. 25R.EXE          Set screen to 25 chars. high       EGA/VGA
  246. 28R.EXE          Set screen to 28 chars. high         VGA
  247. 43R.EXE          Set screen to 43 chars. high       EGA/VGA
  248. 50R.EXE          Set screen to 50 chars. high         VGA
  249.  
  250.  
  251. ANSI View has been configured to work within these video modes.
  252.  
  253. There may be times when the standard 25 line screen is not big
  254. enough to hold the needed menu or other ANSI image so the higher
  255. number of lines per screen can become very useful.  Also, the
  256. visually impaired will welcome the larger letters provided by
  257. 12R.EXE, 14R.EXE, and 21R.EXE for working within the DOS command
  258. line or ANSI View.
  259.  
  260.  
  261.  
  262. If you have any comments or suggestions, I would be very happy to
  263. hear from you.  I can be reached at the following locations:
  264.  
  265. Robert D. Bouman
  266. 94 W Roosevelt Ave.
  267. Zeeland, MI  49464
  268.  
  269.       - or -
  270.  
  271. The Dutch Ghetto BBS
  272. Phone - (616)772-0347
  273. VNET address - 255@6160
  274. My handle - Playster
  275.  
  276.  
  277. Thanks for your interest in ANSI View!
  278.  
  279. Robert D. Bouman
  280.